From 19a4e60fbb0fb02fa7542b5579c40eff00d2f849 Mon Sep 17 00:00:00 2001
From: robertl <robertl@f51c46e8-681c-474f-0cfe-069cfd0219fb>
Date: Sun, 9 Apr 2006 20:30:27 +0000
Subject: [PATCH] Add doc for Garmin_txt from Olaf.

---
 gpsbabel/readme.xml | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/gpsbabel/readme.xml b/gpsbabel/readme.xml
index 5cebd9dc6..d8e21ce1e 100644
--- a/gpsbabel/readme.xml
+++ b/gpsbabel/readme.xml
@@ -588,6 +588,45 @@ in 2005 and later are supported.  See Garmin's site for more info.)
 This is the format readable that that program.</para>
     </section>
 
+    <section id="garmin_txt">
+      <sectioninfo>
+        <subtitle>Garmin MapSource Text Export (tab delimited).</subtitle>
+      </sectioninfo>
+      <title>garmin_txt</title>
+      <para>
+  garmin_txt is a format that contains nearly all information as in the MapSource main format, GDB.
+garmin_txt has some computed values like distances between routepoints and trackpoints, speed, and course (heading) in addition to the standard data fields.
+      <para>
+      <para>
+The main goal of garmin_txt is to make aviation data more available. Because 
+MapSource supports only the export, GPSBabel gives you the possibility to 
+bring aviation data into MapSource.
+      </para>
+During the export with MapSource, some fields are written using local settings
+of MapSource and Windows. These include grid format, gps datum, distance and
+temperature units, and the representation of date and time fields. GPSBabel 
+tries to read all items automatically. Problems with date and time format can 
+be solved with the options 'date' and 'time'.
+      </para>
+      </para>
+      <para>Options:</para>
+      <para><option>date</option> -  input/output date format (Windows-like. For example  "YYYY/MM/DD")</para>
+      <para><option>datum</option> - write coodinates using this (GPSBabel known!) datum </para>
+      <para><option>dist</option> -  output unit for distance values, M (=metric, m/km/kph) or S (=statue, ft/mi/mph)</para>
+      <para><option>prec</option> -  write coordinates with precision # (# numbers behind dot)</para>
+      <para><option>temp</option> -  output unit for temperature values, C (=celsius) or F (=fahrenheit)</para>
+      <para><option>time</option> -  input/output time format (Windows-like For example, "hh:mm:ss xx")</para>
+      <para><option>utc</option> -   write timestamps x hours relative to UTC</para>
+      <example>
+        <title>garmin_txt example with all options:</title>
+	<screen format="linespecific">gpsbabel -i garmin_txt,date="MM/DD/YYYY",time="hh:mm:ss xx" \
+   -f in.txt \
+   -o garmin_txt,date="DD.MM.YYYY",datum="WGS 72",dist=m,prec=6,temp=c,time="HH:mm:ss",utc=+2 \
+   -F out.txt
+        </screen>
+      </example>
+    </section>
+
     <section id="garmin301">
       <sectioninfo><subtitle>Garmin 301 data.</subtitle></sectioninfo>
       <title>garmin301</title> <para>This is a very simple format that
-- 
2.30.2